home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / gawk / gawk213b.zoo / test / awf / awf_1.out next >
Encoding:
Text File  |  1991-04-20  |  6.5 KB  |  199 lines
  1.  
  2.  
  3. AWF(1)                     Unix Programmer's Manual                     AWF(1)
  4.  
  5.  
  6. N✓N✓NA✓A✓AM✓M✓ME✓E✓E
  7.      awf - amazingly workable (text) formatter
  8.  
  9. S✓S✓SY✓Y✓YN✓N✓NO✓O✓OP✓P✓PS✓S✓SI✓I✓IS✓S✓S
  10.      a✓a✓aw✓w✓wf✓f✓f -m✓m✓m_✓a_✓c_✓r_✓o_✓s [ file ] ...
  11.  
  12. D✓D✓DE✓E✓ES✓S✓SC✓C✓CR✓R✓RI✓I✓IP✓P✓PT✓T✓TI✓I✓IO✓O✓ON✓N✓N
  13.      _✓A_✓w_✓f formats the text from the input _✓f_✓i_✓l_✓e(s) (standard input if  none)  in
  14.      an  imitation  of _✓n_✓r_✓o_✓f_✓f's style with the -m✓m✓ma✓a✓an✓n✓n or -m✓m✓ms✓s✓s macro packages.  The
  15.      -m✓m✓m_✓a_✓c_✓r_✓o option is mandatory and must be `-man' or `-ms'.
  16.  
  17.      _✓A_✓w_✓f implements the following raw _✓n_✓r_✓o_✓f_✓f requests:
  18.  
  19.           .\"  .ce  .fi  .in  .ne  .pl  .sp
  20.           .ad  .de  .ft  .it  .nf  .po  .ta
  21.           .bp  .ds  .ie  .ll  .nr  .ps  .ti
  22.           .br  .el  .if  .na  .ns  .rs  .tm
  23.  
  24.      and the following in-text codes:
  25.  
  26.           \$   \%   \*   \c   \f   \n   \s
  27.  
  28.      plus the full list of _✓n_✓r_✓o_✓f_✓f/_✓t_✓r_✓o_✓f_✓f special characters in the  original  V7
  29.      _✓t_✓r_✓o_✓f_✓f manual.
  30.  
  31.      Many restrictions are present; the behavior in general  is  a  subset  of
  32.      _✓n_✓r_✓o_✓f_✓f's.  Of particular note are the following:
  33.  
  34.      +✓o Point sizes do not exist; .✓.✓.p✓p✓ps✓s✓s and \s✓s✓s are ignored.
  35.  
  36.      +✓o Conditionals implement only numeric comparisons on \n✓n✓n(✓(✓(.✓.✓.$✓$✓$,  string  com-
  37.        parisons  between  a macro parameter and a literal, and n✓n✓n (always true)
  38.        and t✓t✓t (always false).
  39.  
  40.      +✓o The implementation of strings is generally primitive.
  41.  
  42.      +✓o Expressions in (e.g.) .✓.✓.s✓s✓sp✓p✓p are fairly general,  but  the  |✓|✓|,  &✓&✓&,  and  :✓:✓:
  43.        operators  do  not  exist,  and  the implementation of \w✓w✓w requires that
  44.        quote (') be used as the delimiter and  simply  counts  the  characters
  45.        inside (so that, e.g., \w'\(bu' equals 4).
  46.  
  47.      White space at the beginning of lines, and imbedded  white  space  within
  48.      lines, is dealt with properly.  Sentence terminators at ends of lines are
  49.      understood to imply extra space afterward in filled lines.  Tabs are  im-
  50.      plemented  crudely  and  not quite correctly, although in most cases they
  51.      work as expected.  Hyphenation is done  only  at  explicit  hyphens,  em-
  52.      dashes, and _✓n_✓r_✓o_✓f_✓f discretionary hyphens.
  53.  
  54. M✓M✓MA✓A✓AN✓N✓N M✓M✓MA✓A✓AC✓C✓CR✓R✓RO✓O✓OS✓S✓S
  55.      The -m✓m✓ma✓a✓an✓n✓n macro set implements the full V7 manual macros, plus a few semi-
  56.      random oddballs.  The full list is:
  57.  
  58.           .B   .DT  .IP  .P   .RE  .SM
  59.           .BI  .HP  .IR  .PD  .RI  .TH
  60.           .BR  .I   .LP  .PP  .RS  .TP
  61.           .BY  .IB  .NB  .RB  .SH  .UC
  62.  
  63.  
  64. U of Toronto                          13 July 1990                           1
  65.  
  66.  
  67.  
  68.  
  69. AWF(1)                     Unix Programmer's Manual                     AWF(1)
  70.  
  71.  
  72.      .✓.✓.B✓B✓BY✓Y✓Y and .✓.✓.N✓N✓NB✓B✓B each take a single string argument  (respectively,  an  indi-
  73.      cation  of authorship and a note about the status of the manual page) and
  74.      arrange to place it in the page footer.
  75.  
  76. M✓M✓MS✓S✓S M✓M✓MA✓A✓AC✓C✓CR✓R✓RO✓O✓OS✓S✓S
  77.      The -m✓m✓ms✓s✓s macro set is a substantial subset of the  V7  manuscript  macros.
  78.      The implemented macros are:
  79.  
  80.           .AB  .CD  .ID  .ND  .QP  .RS  .UL
  81.           .AE  .DA  .IP  .NH  .QS  .SH  .UX
  82.           .AI  .DE  .LD  .NL  .R   .SM
  83.           .AU  .DS  .LG  .PP  .RE  .TL
  84.           .B   .I   .LP  .QE  .RP  .TP
  85.  
  86.      Size changes are recognized but ignored, as are .✓.✓.R✓R✓RP✓P✓P and  .✓.✓.N✓N✓ND✓D✓D.   .✓.✓.U✓U✓UL✓L✓L  just
  87.      prints  its  argument in italics.  .✓.✓.D✓D✓DS✓S✓S/.✓.✓.D✓D✓DE✓E✓E does not do a keep, nor do any
  88.      of the other macros that normally imply keeps.
  89.  
  90.      Assignments to the header/footer  string  variables  are  recognized  and
  91.      implemented,  but  there  is  otherwise  no  control  over  header/footer
  92.      formatting.  The D✓D✓DY✓Y✓Y string variable is available.  The  P✓P✓PD✓D✓D,  P✓P✓PI✓I✓I,  and  L✓L✓LL✓L✓L
  93.      number registers exist and can be changed.
  94.  
  95. O✓O✓OU✓U✓UT✓T✓TP✓P✓PU✓U✓UT✓T✓T
  96.      The only output format supported by _✓a_✓w_✓f, in its distributed form, is that
  97.      appropriate  to  a  dumb  terminal,  using  overprinting for italics (via
  98.      underlining) and bold.  The _✓n_✓r_✓o_✓f_✓f special characters are printed as  some
  99.      vague   approximation  (it's  sometimes  very  vague)  to  their  correct
  100.      appearance.
  101.  
  102.      _✓A_✓w_✓f's knowledge of the output device is established  by  a  device  file,
  103.      which  is  read  before  the user's input.  It is sought in _✓a_✓w_✓f's library
  104.      directory, first as d✓d✓de✓e✓ev✓v✓v.✓.✓._✓t_✓e_✓r_✓m  (where  _✓t_✓e_✓r_✓m  is  the  value  of  the  TERM
  105.      environment  variable)  and,  failing that, as d✓d✓de✓e✓ev✓v✓v.✓.✓.d✓d✓du✓u✓um✓m✓mb✓b✓b.  The device file
  106.      uses special internal commands to set up resolution, special  characters,
  107.      fonts, etc., and more normal _✓n_✓r_✓o_✓f_✓f commands to set up page length etc.
  108.  
  109. F✓F✓FI✓I✓IL✓L✓LE✓E✓ES✓S✓S
  110.      All in /_✓u_✓s_✓r/_✓l_✓i_✓b/_✓a_✓w_✓f (this can be overridden  by  the  AWFLIB  environment
  111.      variable):
  112.  
  113.      common     common device-independent initialization
  114.      dev.*      device-specific initialization
  115.      mac.m*     macro packages
  116.      pass1      macro substituter
  117.      pass2.base central formatter
  118.      pass2.m*   macro-package-specific bits of formatter
  119.      pass3      line and page composer
  120.  
  121. S✓S✓SE✓E✓EE✓E✓E A✓A✓AL✓L✓LS✓S✓SO✓O✓O
  122.      awk(1), nroff(1), man(7), ms(7)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. U of Toronto                          13 July 1990                           2
  131.  
  132.  
  133.  
  134.  
  135. AWF(1)                     Unix Programmer's Manual                     AWF(1)
  136.  
  137.  
  138. D✓D✓DI✓I✓IA✓A✓AG✓G✓GN✓N✓NO✓O✓OS✓S✓ST✓T✓TI✓I✓IC✓C✓CS✓S✓S
  139.      Unlike _✓n_✓r_✓o_✓f_✓f, _✓a_✓w_✓f complains whenever it sees unknown commands and macros.
  140.      All diagnostics (these and some internal ones) appear on standard error
  141.      at the end of the run.
  142.  
  143. H✓H✓HI✓I✓IS✓S✓ST✓T✓TO✓O✓OR✓R✓RY✓Y✓Y
  144.      Written at University of Toronto by Henry Spencer,  more  or  less  as  a
  145.      supplement to the C News project.
  146.  
  147.                      =✓> None of the above really want to admit it. =✓<
  148.  
  149. B✓B✓BU✓U✓UG✓G✓GS✓S✓S
  150.      There are plenty, but what do you expect for  a  text  formatter  written
  151.      entirely in (old) _✓a_✓w_✓k?
  152.  
  153.      The -m✓m✓ms✓s✓s stuff has not been checked out very thoroughly.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. U of Toronto                          13 July 1990                           3
  197.  
  198.  
  199.